TinyUSB 开源项目教程

1. 项目的目录结构及介绍

TinyUSB 项目的目录结构如下：

├── docs # 文档
├── examples # 示例，包含 make 和 cmake 构建系统
├── hw
│   ├── bsp # 支持的开发板源文件
│   └── mcu # 低级 MCU 核心和外设驱动
├── lib # 第三方源文件，如 freeRTOS、fatfs
├── src # TinyUSB 堆栈的所有源文件
├── test # 测试：单元测试、模糊测试、硬件测试
└── tools # 内部使用的文件

目录介绍

• docs: 包含项目的在线文档。
• examples: 包含使用 make 和 cmake 构建系统的示例。
• hw/bsp: 包含支持的开发板的源文件。
• hw/mcu: 包含低级 MCU 核心和外设驱动。
• lib: 包含第三方库，如 freeRTOS、fatfs。
• src: 包含 TinyUSB 堆栈的所有源文件。
• test: 包含单元测试、模糊测试和硬件测试。
• tools: 包含内部使用的工具文件。

2. 项目的启动文件介绍

TinyUSB 项目的启动文件通常位于 hw/mcu 目录下，具体文件名和内容会根据不同的 MCU 而有所不同。启动文件主要负责初始化 MCU 和外设，为 TinyUSB 的运行提供必要的环境。

示例启动文件

以下是一个示例启动文件的结构：

#include "tusb.h"

void SystemInit(void) {
    // 系统初始化代码
}

int main(void) {
    SystemInit();
    tusb_init();

    while (1) {
        tud_task();
    }
}

启动文件介绍

• SystemInit: 系统初始化函数，负责初始化 MCU 和外设。
• main: 主函数，初始化 TinyUSB 并进入主循环，处理 USB 任务。

3. 项目的配置文件介绍

TinyUSB 项目的配置文件是 tusb_config.h，该文件定义了 TinyUSB 的各种配置选项，包括 MCU 类型、操作系统、USB 描述符等。

配置文件示例

以下是一个示例配置文件的结构：

#ifndef _TUSB_CONFIG_H_
#define _TUSB_CONFIG_H_

#define CFG_TUSB_MCU OPT_MCU_STM32F4
#define CFG_TUSB_OS OPT_OS_NONE

#define CFG_TUSB_RHPORT0_MODE OPT_MODE_DEVICE

#define CFG_TUSB_DEBUG 0

#endif

配置文件介绍

• CFG_TUSB_MCU: 定义使用的 MCU 类型。
• CFG_TUSB_OS: 定义使用的操作系统。
• CFG_TUSB_RHPORT0_MODE: 定义 USB 端口模式（设备或主机）。
• CFG_TUSB_DEBUG: 定义调试级别。

通过配置文件，可以灵活地调整 TinyUSB 的行为，以适应不同的应用场景。