基于 RT-Thread 软件包开发指南

本节主要介绍使用 RT-Thread 提供的软件包管理器来配置工程，以 env 作为演示。本节操作不同芯片都一样，后续不再重复讲解。打开 env 以后使用 menuconfig 进入包管理器，并在如图所示路径中选择 CherryUSB。

从机配置

• 选择 Enable usb device mode 并敲回车进入。

• 首先第一个配置是配置 USB 的速度，分为 FS、HS，表示使用全速还是高速功能。

• 其次第二个配置则是选择 USB device ip，不清楚自己芯片是哪个 ip 的可以参考 port 目录下对应的 readme。

• 选择好 USB device ip 以后，还需要选择是哪款芯片，第三个配置则是用来选择芯片，选择以后会帮忙配置相对应的 ip 的一些信息，比如 USB_BASE 、 USBD_Handler 以及特殊的一些配置等等，如果没找到自己的芯片，可以手动在 usb_dc_xxx.c 中修改。

• 接下来是 class 的选择，用哪个 class 勾选哪个就可以了，使能 class 以后，双击进入可以选择一个 demo 的模板参与编译，当然也可以不选，自己写。

• 最后退出保存即可。

• 退出以后不急着编译，需要在代码中实现 usb_dc_low_level_init 函数。

• 复制一份 usb_config.h 到自己的目录中，并实现以下内容：

• 使用 scons –target=mdk 或者 scons 进行编译

主机配置

• 选择 Enable usb host mode 并敲回车进入。

• 选择 USB host ip，不清楚自己芯片是哪个 ip 的可以参考 port 目录下对应的 readme。选择好 USB host ip 以后，还需要选择是哪款芯片，第二个箭头则是用来选择芯片，选择以后会帮忙配置相对应的 ip 的一些信息，比如 USB_BASE 、 USBH_Handler 以及特殊的一些配置等等，如果没找到自己的芯片，可以手动在 usb_hc_xxx.c 中修改。

• 默认使能除了 hub 之外的所有 class 驱动。

• 设置 psc 线程的线程栈以及线程优先级。

• 最后退出保存即可。

• 退出以后不急着编译，需要在代码中实现 usb_hc_low_level_init 函数。

• 复制一份 usb_config.h 到自己的目录中，并实现以下内容：

• 使用 scons –target=mdk 或者 scons 进行编译

• 如果使用的是 GCC ，需要在链接脚本(ld)中添加如下代码：

/* section information for usbh class */
. = ALIGN(4);
__usbh_class_info_start__ = .;
KEEP(*(.usbh_class_info))
__usbh_class_info_end__ = .;

借助 STM32CubeMX 生成 USB 初始化

使用 STM32CubeMX 主要是用来生成 usb 时钟、引脚、中断的配置。我们需要点击如图所示文件，并配置好 USB 的时钟、中断，点击 Generate Code。生成的时钟配置在 main.c 中的 SystemClock_Config 文件，将其拷贝到 board.c 中。

然后将 stm32xxxx_hal_msp.c 中的 HAL_PCD_MspInit 或者是 HAL_HCD_MspInit 中的内容复制到 usb_dc_low_level_init 和 usb_hc_low_level_init 函数中，举例如下：

其次将 main.c 中的 SystemClock_Config 替换掉 board.c 中的配置