RT-Thread-Studio环境下ST M7系列USB主机（CherryUSB）配置及踩坑RT-Thread问答社区

Studio环境下ST M7系列USB主机（CherryUSB）配置及踩坑

发布于 2025-04-05 17:57:31 浏览：115 订阅该版

[tocm]

# 感谢 [@sakumisu](/u/0e57f90a3018a1b9)（CherryUSB作者）的多次指点。

**文档是飞书直接复制过来的，排版不好看，不过我相信应该看得懂**
**可能有些地方后面实际更正了，但是文档忘了更新**

# Cubemx

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/0d77501e4e2c1ed5c55edb894ef4f8af.png.webp)

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/e1185f25ce0f7aede4f9c21dbed08851.png.webp)
# Settings

不需要添加RTT的USB组件

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/bac49ebcaf5b894ae35ce4900d583a46.png.webp)

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/90bb3a3a55cca70f6eda57caabad8ba2.png)

![screenshot_undefined](undefined)
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/90bb3a3a55cca70f6eda57caabad8ba2.png)

# 其他必要工作
## 手动添加init设备对接协议栈

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/1436f255e19afe86afaddcc1268543d4.png.webp)
以下是代码
```c

void usb_hc_low_level_init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};
      RCC_PeriphCLKInitTypeDef PeriphClkInitStruct = {0};

PeriphClkInitStruct.PeriphClockSelection = RCC_PERIPHCLK_USB;
        PeriphClkInitStruct.UsbClockSelection = RCC_USBCLKSOURCE_HSI48;
        if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInitStruct) != HAL_OK)
        {
          Error_Handler();
        }
        HAL_PWREx_EnableUSBVoltageDetector();
        __HAL_RCC_GPIOA_CLK_ENABLE();
        GPIO_InitStruct.Pin = GPIO_PIN_11|GPIO_PIN_12;
        GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
        GPIO_InitStruct.Pull = GPIO_NOPULL;
        GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
        GPIO_InitStruct.Alternate = GPIO_AF10_OTG1_FS;
        HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
        __HAL_RCC_USB_OTG_FS_CLK_ENABLE();
        HAL_NVIC_SetPriority(OTG_FS_IRQn, 0, 0);
        HAL_NVIC_EnableIRQ(OTG_FS_IRQn);
}
void OTG_FS_IRQHandler(void)
{
    extern void USBH_IRQHandler(uint8_t busid);
    USBH_IRQHandler(0);
}

int usbh_init(void)
{
    usbh_initialize(0, USB2_OTG_FS_PERIPH_BASE);
    return 0;
}

INIT_APP_EXPORT(usbh_init);
```
## 添加USB设备内存地址

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/d6c6984f611d101d1578df7a4a11c456.png.webp)

```c
. = ALIGN(4);
__usbh_class_info_start__ = .;
KEEP(*(.usbh_class_info))
__usbh_class_info_end__ = .;
```
## 屏蔽rtt软件包自带的初始化函数

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/b862948a641c974d36f2753a6c2ecf55.png.webp)
## 配置config参数

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/ec5df386517a922aad7488a0e6517847.png.webp)
## 修改软件定时器栈大小

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/da8481d99ce0e36c2cd3316a6ff1af29.png.webp)
## 添加NOCACHE（针对高端芯片）
因为用到了DMA，所以有一个一致性问题

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/3c3a8aac86c2dc45488223460c7abc74.png.webp)

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/c04419f34e63d8d1073ca800b5fb5a49.png.webp)

```c
RAM_nocache (rwx) : ORIGIN =0x24070000,LENGTH =64k
        ._nocache_ram (NOLOAD):
        {
        . = ALIGN(4);
        *(.noncacheable)
        } >RAM_nocache
```
此时编译，就可以查看map文件地址，nocache数组位置正确与否

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/854eeea91de2f90c2f396fbfe29bd5d8.png.webp)
前面只是设置了数组位置，我们还没有讲这个位置配置成nocache

![screenshot_QQ_1743846344594.png](https://oss-club.rt-thread.org/uploads/20250405/ed5d18ffe5bf91b5f607c792491e5522.png.webp)

附上这段代码和，kconfig配置

```python
        config BSP_USING_USBH
    bool "Enable USB HOST"
    default n   
    
        if BSP_USING_USBH
    config BSP_USB_NOCACHE
        bool "Enable USB NOCACHE"
        default n
    endif
```
# 各种log错误
## This dwc2 version does not support dma mode, so stop working

该 DWC2 版本不支持 dma 模式，禁止使用。或者是因为寄存器地址错误，如下

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/4a624cdd98c72d5af6a7ef185349cc3a.png.webp)

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/20179df48040f89b2559a1d05dbea80d.png.webp)
## Your fifo config is overflow, please check

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/12d09729da6c7a3c12b1a6113f67a450.png.webp)

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/811a6469329e4418133f0e5a85f3f855.png.webp)
Failed to get device descriptor,errorcode:-12
配置nocache
## 能识别到插拔，插上立即崩溃

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/12eeccb29f4ccaef496396fbdf6c2783.png.webp)

可能的情况很多，我遇到的这个情况是栈问题，根本问题是nocache的地址设置错误

## 能识别到插拔，但枚举不到报错误log，

![screenshot_undefined](undefined)
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250405/e0c20c1708d6035fe2d3ce0d040b22bb.png.webp)
直接把mpu全关了

也有不关闭mpu的方法，“参考文档，和demo，还有视频”————sakumisu

我看的demo