Mbed OS BLE 示例项目指南

该项目位于 https://github.com/ARMmbed/mbed-os-example-ble.git，提供了一系列基于Mbed OS的蓝牙低功耗（BLE）示例应用。本指南将详细介绍项目的目录结构、启动文件以及配置文件，帮助您快速上手开发。

1. 目录结构及介绍

Mbed OS BLE 示例项目遵循了典型的Mbed OS项目布局，其大致结构如下：

mbed-os-example-ble/
│
├── COPYRIGHT          # 版权声明文件
├── CMakeLists.txt     # CMake构建系统配置文件
├── README.md          # 项目概述和入门指南
├── api                # BLE API相关示例代码或库文件
├── examples           # 各种BLE应用场景的实例子目录
│   ├── ExampleName    # 每个子目录对应一个具体的BLE示例应用
│   │   ├── main.cpp   # 主程序入口文件
│   │   └── ...
│
├── mbed_app.json      # 应用配置文件，用于定义编译选项和配置
├── mbed-os            # Mbed OS框架的软链接或子模块，具体依赖方式依据项目设置
└── ...

• COPYRIGHT: 记录版权信息。
• CMakeLists.txt: 指导CMake如何构建整个项目，支持Mbed CLI 2及其使用的Ninja构建系统。
• README.md: 提供项目简介、快速入门步骤和其他重要信息。
• api: 包含对BLE API的具体使用示例或额外封装的API。
• examples: 核心部分，每个子目录包含一个完整的BLE应用案例。
  • ExampleName: 表示单个示例的应用名称，其中main.cpp为主要执行文件。
• mbed_app.json: 项目特定的配置文件，允许自定义编译选项、选择特性等。
• mbed-os: 是Mbed OS的核心库，可能作为一个子模块存在，包含了所有必要的操作系统服务和外设驱动。

2. 项目的启动文件介绍

在Mbed OS项目中，启动文件通常不在单独的文件内定义，而是通过main.cpp来实现项目的启动逻辑。因此，对于BLE示例项目而言，main.cpp就是实质上的“启动文件”。它初始化硬件，设置BLE堆栈，并启动应用程序的主要循环。在每个位于examples目录下的子目录里，您能找到对应的main.cpp，它们展示了如何初始化BLE服务和特征，以及如何处理事件和数据传输。

3. 项目的配置文件介绍

mbed_app.json

项目中的关键配置文件是mbed_app.json。此文件允许您进行以下配置:

• target_overrides: 针对不同目标硬件的编译和链接选项。
• features: 指定项目所需的功能，例如BLE支持必须在此列出。
• config: 定义项目的配置参数，可以覆盖Mbed OS默认配置。
• source_files: 显式指定项目源码文件，尽管通常是自动发现的。
• build_options: 包括优化级别、警告处理等编译器选项。

例如，启用BLE功能并针对特定的硬件配置可能会有如下简化的配置片段：

{
    "target_overrides": {
        "*": {
            "platform.stdlib": "none",
            "target.features_add": ["BLE"]
        }
    },
    "features": ["FEATURE_BLE"],
    "config": {
        "ble_advertising_interval_ms": 500
    }
}

以上是关于Mbed OS BLE 示例项目的基本解析，涵盖目录结构、启动逻辑概览和关键配置文件的介绍，希望这对您的开发工作有所帮助。