【亲测免费】 CherryUSB 安装和配置指南

1. 项目基础介绍和主要编程语言

项目基础介绍

CherryUSB 是一个专为嵌入式系统设计的轻量级、美观且可移植的 USB 主机和设备栈。它旨在简化 USB 在嵌入式系统中的使用，提供易于学习和使用的 API，支持多种 USB 类设备，如 CDC、HID、MSC 等。

主要编程语言

CherryUSB 主要使用 C 语言编写，适用于嵌入式系统的开发。

2. 项目使用的关键技术和框架

关键技术

• USB 主机和设备栈：支持 USB 2.0 全速和高速，USB 3.0 超高速。
• 类驱动支持：包括 CDC、HID、MSC、UVC、UAC、DFU、MIDI、RNDIS 等。
• 端点中断回调：允许用户在端点中断回调中执行自定义操作。
• 复合设备支持：支持多个设备在同一 USB 总线上。

框架

• CherryUSB 设备栈：提供统一的框架来处理标准设备请求、类请求、供应商请求和自定义请求。
• CherryUSB 主机栈：提供标准的枚举实现，支持多级 HUB 和自动加载类驱动。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

1. 开发环境：确保你已经安装了适合嵌入式开发的编译工具链，如 GCC 或 ARM GCC。
2. 版本控制系统：安装 Git，用于克隆项目代码。
3. 依赖项：确保你的开发环境中已经安装了必要的依赖项，如 CMake 或 SCons。

详细安装步骤

步骤 1：克隆项目代码

首先，使用 Git 克隆 CherryUSB 项目到本地：

git clone https://github.com/cherry-embedded/CherryUSB.git

步骤 2：进入项目目录

进入克隆下来的项目目录：

cd CherryUSB

步骤 3：配置项目

根据你的嵌入式平台，配置 CherryUSB。你可以使用提供的配置模板文件 cherryusb_config_template.h 进行配置。

cp cherryusb_config_template.h cherryusb_config.h

编辑 cherryusb_config.h 文件，根据你的硬件平台和需求进行配置。

步骤 4：编译项目

使用 CMake 或 SCons 进行编译。以下是使用 CMake 的示例：

mkdir build
cd build
cmake ..
make

步骤 5：烧录和测试

将编译生成的二进制文件烧录到你的嵌入式设备中，并进行测试。确保你的设备支持 USB 功能，并连接到主机进行测试。

配置示例

以下是一个简单的配置示例，假设你使用的是 STM32 平台：

#define CONFIG_USB_DEVICE_ONLY
#define CONFIG_USB_DEVICE_SPEED_FULL
#define CONFIG_USB_DEVICE_CDC_ACM

常见问题

• 编译错误：确保你的编译工具链和依赖项已正确安装。
• 运行时错误：检查硬件连接和配置文件是否正确。

通过以上步骤，你应该能够成功安装和配置 CherryUSB 项目，并在你的嵌入式系统中使用它。